home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / utilities / u258.dms / in.adf / UserDocs / Manual_Pages / Set < prev    next >
Encoding:
Text File  |  1988-02-12  |  3.5 KB  |  133 lines
  1.  
  2.  
  3.  
  4.      Set(REL2)             ARP User's    Manual             Set(REL2)
  5.  
  6.  
  7.  
  8.      NAME
  9.       Set -    Set or clear the value of an environment variable
  10.  
  11.      SYNOPSIS
  12.       Set Variable=Value/... ESCAPE/k BCPL/K LISTALL/S
  13.  
  14.      Description
  15.       Environment variables    are something which ARP    brings to the
  16.       Amiga.  We were not the first, Manx first used Environment
  17.       variables extensively, and our implementation    supports them.
  18.       All Manx software currently in use will work with
  19.       arp.library and its environment variable support.
  20.  
  21.       Environment variables    are very useful    in setting specific
  22.       behaviour for    different users. ARP programs currently    use
  23.       two environment variables, one is used by all    the programs
  24.       which    process    dates, such as SetDate,    Date, List, and    so on.
  25.       This variable    is called "dateformat",    and determines the
  26.       format of input and output the command should    accept and
  27.       perform.  The    other variable is called "copyflags" and is
  28.       used by the ARP Copy program.     For more information on these
  29.       variables, see the manual pages for any of these programs.
  30.  
  31.       To set the value of an environment variable, simply use SET
  32.       VARNAME=VAL, which sets the value of VARNAME to VAL.    To
  33.       remove this environment variable do Set VARNAME= or Set
  34.       VARNAME.  REL2 of Set    uses Multiargs,    so there is no limit
  35.       to the number    of variables you can set and clear with    one
  36.       command.  You    can intermix setting and clearing variables on
  37.       the same command line.
  38.  
  39.       To view the values of    all current environment    variables,
  40.       simply use Set without any arguments.
  41.  
  42.       You can use spaces in    your variable names and    values,    but it
  43.       is not generally a good idea.     If you    do use spaces, you
  44.       must surround    the complete expression    with double quotes,
  45.       i.e.,    "Variable Name=Variable    Value".    Note that the similar
  46.       looking expression "Variable Name = Variable Value" has
  47.       hidden spaces.  The Variable ends with a space, and the
  48.       value    begins with one. This is only one example of how
  49.       problematical    spaces in environment variables    and values can
  50.       become.
  51.  
  52.       REL2 of Set also has special features    for setting the    Escape
  53.       character and    increasing the amount of BCPL compatibility.
  54.       You can set the current escape character by using the    ESCAPE
  55.       <char> keyword.
  56.  
  57.       One source of    problems with old script files and ARP is the
  58.       use of the star "*" to refer to the current window.  ARP
  59.       programs tend    to regard the star "*" as a wildcard, as is
  60.  
  61.  
  62.  
  63.      Page 1                         (printed 2/22/88)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      Set(REL2)             ARP User's    Manual             Set(REL2)
  71.  
  72.  
  73.  
  74.       common.  If you use the BCPL keyword to do SET BCPL TRUE,
  75.       those    programs which tend to have problems with this will
  76.       attempt to overlook the "*" as a wildcard.
  77.  
  78.       Finally, you can get a listing of all    variables, including
  79.       the values of    ESCAPE and BCPL    by using the keyword LISTALL.
  80.  
  81.      EXAMPLE
  82.       Set DODAH=SONG dateformat=0 copyflags= ESCAPE    \
  83.  
  84.       The command line above creates or redefines the variable
  85.       DODAH    to have    the value SONG,    dateformat to have the value
  86.       0, removes the variable copyflags from the environment, and
  87.       sets the current ESCAPE character to \.
  88.  
  89.      ADDITIONAL    CONSIDERATIONS
  90.       Manx users should not    mix the    MANX set and the ARP set, as
  91.       this could result in problems, although nothing definite is
  92.       known. If you    wish to    use the    ARP set, simply    copy it    to
  93.       your BIN directory.  Other than this,    there should be    no
  94.       problems between the ARP environment and the Manx
  95.       environment.
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                         (printed 2/22/88)
  130.  
  131.  
  132.  
  133.